home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d17 / frmfit30.arc / FORMFIT.DOC < prev    next >
Text File  |  1988-02-19  |  74KB  |  1,851 lines
  1. P
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                                   F O R M F I T !
  20.  
  21.                                     Version 3.0
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.                           R E F E R E N C E    M A N U A L
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.                                   Sidebar Software
  42.                                 103 Inglewood Circle
  43.                                 Tullahoma, TN  37388
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.                     (C) Copyright  1987, 1988   Sidebar Software
  52.                                 All Rights Reserved
  53.  
  54.  
  55.  Formfit! 3.0
  56.  (C) Copyright 1987, 1988 Sidebar Software
  57.  
  58.  
  59.  
  60.                                       WARRANTY
  61.  
  62.  
  63.          Sidebar Software makes no warranty of any kind, expressly or
  64.          implied, regarding Formfit! and/or its accompanying documentation.
  65.          Sidebar Software will not be responsible for any damages, whether
  66.          direct or indirect, incurred by users as a result of running this
  67.          program, or due to failure of this product to meet any and/or all
  68.          the stated specifications.  This program is distributed strictly on
  69.          an "as is" basis, without exception.  In no way will Sidebar
  70.          Software be liable to you for lost profits, lost assets, lost
  71.          savings, or loss of potential gain due to the use or inability to
  72.          use this program, in part or in full.
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.          Specifications, features, and capabilities outlined in this manual
  89.          and incorporated into the program Formfit! are subject to change
  90.          without notice.
  91.  
  92.          Formfit! is a trademark of Sidebar Software.
  93.  
  94.          Formfit! software copyright 1986, 1987, 1988 by Sidebar Software.
  95.          All rights reserved.
  96.  
  97.          This reference manual copyright 1988 by Sidebar Software.  All
  98.          rights reserved.
  99.  
  100.          This manual contains references to both software and hardware names
  101.          which are trademarks of various manufacturers.
  102.  
  103.          This program was written using Microsoft QuickBASIC 3.0.  Special
  104.          thanks to Dave Evers for the BASWIND routines.
  105.  
  106.  
  107.          Printed in the United States of America.
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.                                      ii
  115.  
  116.  
  117.  Formfit! 3.0
  118.  (C) Copyright 1987, 1988 Sidebar Software
  119.  
  120.  
  121.  
  122.                                       LICENSE
  123.  
  124.  
  125.          Formfit! (and its accompanying documentation) is copyright (C)
  126.          1987, 1988 by Sidebar Software of Tullahoma, Tennessee.  All
  127.          versions of this program, including 3.0, are not public domain
  128.          software, nor are they free software.  After a suitable trial
  129.          period, to continue to use Formfit!, you are expected to register
  130.          your copy.  This period will naturally vary from user to user, but
  131.          we at Sidebar Software feel that if you have run this program ten
  132.          (10) or so times, for the purpose of productively using it (as
  133.          opposed to introducing yourself and/or others to its functions,)
  134.          you are an active user, and are expected to register your copy.
  135.          Non-registered users are granted a limited license to use Formfit!
  136.          on a trial basis, for the purpose of familiarizing themselves with
  137.          its operation and determining personal usefulness.  To continue
  138.          using Formfit! without registration is forbidden.
  139.  
  140.          Registration allows the use of Formfit! for a single user.  You may
  141.          transport Formfit! to any machine for the purpose of personal use,
  142.          but operators and/or owners of multi-user systems must obtain a
  143.          site license, or register a copy for each user who has access to
  144.          Formfit!  Commercial users MUST obtain registration via a site
  145.          license.  Write to us for more information about site licensing.
  146.          Registered users are permitted to make backup copies of Formfit!
  147.          for personal archival purposes, and all individual users are
  148.          permitted (and encouraged) to copy the entire Formfit! package for
  149.          other users to try and evaluate, pursuant to this licensing
  150.          agreement.  Distributors of public domain or user supported
  151.          software may distribute copies of Formfit! according to the above
  152.          conditions only after receiving written permission to do so from
  153.          Sidebar Software.  This is a routine and simple procedure, so
  154.          please write for more details.
  155.  
  156.          Formfit! may not be distributed as a part of any other product or
  157.          sales campaign.  It is intended to be distributed from personal
  158.          user to personal user.  Electronic bulletin board systems (BBS) may
  159.          be used to store and distribute this program to individual users,
  160.          according to the individual system operator's (SYSOP) local board
  161.          rules and directives.  Always abide by the SYSOP's rules and
  162.          regulations, as modern, personal telecommunications owes a great
  163.          debt to these dedicated men and women.
  164.  
  165.          If you are the author of user supported software, and have license
  166.          granting power over the same, contact us about mutual reciprocal
  167.          licensing of our product to you in exchange for the license to use
  168.          your software here at Sidebar.
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.                                     iii
  177.  
  178.  
  179.  Formfit! 3.0
  180.  (C) Copyright 1987, 1988 Sidebar Software
  181.  
  182.  
  183.  
  184.                               REGISTRATION INFORMATION
  185.  
  186.  
  187.          Your one-time registration entitles you to all future updates of
  188.          Formfit!  While no copies of any updates will automatically be sent
  189.          to you directly, your name will be added to our customer database,
  190.          and notice of any updates or program enhancements will be sent to
  191.          you, if you so desire (indicate on the registration form.)  Also,
  192.          by indicating that you desire to be placed on our mailing list, you
  193.          will receive notices for any new products introduced by Sidebar
  194.          Software.  (Under no circumstances will any customer names,
  195.          addresses, etc. be given or sold to any third parties.)  For only
  196.          the price of the disk and mailing (or free, if you provide your own
  197.          disk and a postage paid, self addressed mailer,) you can receive
  198.          the current, updated version of Formfit!  Keep an eye on your local
  199.          BBS's, too, for the latest version of Formfit!
  200.  
  201.          By registering your copy of Formfit! you are signifying your
  202.          expected continued use of our product.  We are glad that you have
  203.          found Formfit! useful, and will continue to be thankful for users
  204.          like yourself.  Appendix B. contains the necessary form for
  205.          registering your copy of Formfit!
  206.  
  207.  
  208.  
  209.  
  210.                                ABOUT SIDEBAR SOFTWARE
  211.  
  212.  
  213.          Sidebar Software has been in existence since March, 1986.  Our
  214.          products are developed in response to real world needs.  We use
  215.          computers here at Sidebar daily, and run into our share of brick
  216.          walls to circumvent.  We try to keep our approach simple, and our
  217.          human interface as clean as possible.  We are very open to
  218.          suggestions and criticisms.  In fact, at one time we toyed with the
  219.          idea that for every 5 first-time reported bugs in a program, or
  220.          typos in a manual, we would grant registration and license
  221.          privileges to the sender.  However, this would result in most folks
  222.          being told "sorry, someone else found it first," and so we tabled
  223.          that idea.  But the point is, we constantly look for new and fresh
  224.          user-producer avenues of communication, so please write to us
  225.          concerning any aspect of our products and/or policies.  We, as a
  226.          group, believe in God, and try to follow Him in all we do.  We also
  227.          believe that a person's eternal soul is far too valuable to risk
  228.          for a few unregistered or pirated computer programs.  If you are
  229.          going to use Formfit! (or anyone else's software, for that matter),
  230.          then give the author his/her due, if so requested.  If you're not
  231.          going to use it, pass it on.  Maybe someone else will find it
  232.          helpful.  Thanks, from all of us at Sidebar Software.
  233.  
  234.  
  235.  
  236.  
  237.  
  238.                                      iv
  239.  
  240.  
  241.  Formfit! 3.0
  242.  (C) Copyright 1987, 1988 Sidebar Software
  243.  
  244.  
  245.  
  246.                              ABOUT FORMFIT! VERSION 3.0
  247.  
  248.  
  249.          Formfit! allows you to quickly fill out preprinted forms using your
  250.          computer's printer.  You electronically "define" forms according to
  251.          where information is to be printed, and you label these locations
  252.          for ease of reference.  Rich with editing options, you can later
  253.          edit just the information which has become outdated, supply new
  254.          information, and reprint to a new form.  The form itself can be
  255.          redefined entry by entry at any time.  The definitions can be
  256.          entered in any sequence desired.  This allows grouping together
  257.          entries which change often, even though they may be physically far
  258.          apart from each other on the form.  You can quickly move or delete
  259.          blocks of these definitions to suit changing needs, even when the
  260.          layout of the form changes significantly.  (Formfit! is also great
  261.          for envelopes, labels, etc.)
  262.  
  263.          This program was written by Greg Nordstrom, the founder of Sidebar
  264.          Software, while he was an engineering undergraduate at Arizona
  265.          State University.  The bureaucratic way of life at the university
  266.          called for many changes to be filed as expected course work and/or
  267.          requirements changed.  And it was up to the students to
  268.          reaccomplish the required forms, in triplicate.  By defining the
  269.          common forms just once, Greg had to then only change a line or two
  270.          of information, roll in a new blank form, and in 5 minutes or less,
  271.          the job was done.  Those of you who work with forms on a regular
  272.          basis will enjoy and benefit from this program from the very first
  273.          day you begin to use it.
  274.  
  275.          Formfit! has undergone several changes, both major and minor.
  276.          Minor changes are made periodically, and do not require the re-
  277.          printing of a manual.  Users of previous versions can just read the
  278.          UPDATE.DOC file for reference.  Minor changes are noted by version
  279.          number changes to the right of the decimal.  For example, a minor
  280.          change to version 2.0 would be numbered 2.1.  Major revisions
  281.          require all users to print out a new manual.  A major change is
  282.          given a new version number to the left of the decimal.  Version 3.0
  283.          is a major change from 2.1.
  284.  
  285.          Versions 1.x were considerably less flexible than the 2.x series.
  286.          Version 2.0 had a rather nasty bug in the editor that only surfaced
  287.          when defining forms larger than 99 columns wide.  This led to a
  288.          recoding of the editor section of Formfit! in version 2.1.  Also
  289.          included in version 2.1 were several human interface improvements,
  290.          such as more logical menu selection, and quicker response to input.
  291.          Version 3.0 adds several new features to Formfit!   Due to the
  292.          large number of improvements, added features, and enhancements, the
  293.          basic file structure is no longer the same, and users of 1.0 or 1.1
  294.          will have to manually redefine any forms they wish to use.  Version
  295.          2.x users can convert their default and definition files to the 3.0
  296.          format by using the program CONVERT.COM included in the Formfit!
  297.          version 3.0 package.  A few of the major highlights of version 3.0
  298.          are listed on the following page.
  299.  
  300.                                      v
  301.  
  302.  
  303.  Formfit! 3.0
  304.  (C) Copyright 1987, 1988 Sidebar Software
  305.  
  306.  
  307.  
  308.                                Version 3.0 Highlights
  309.  
  310.  
  311.               o    Deleting definitions may now be done by blocks as
  312.               well as individually.  The user has the option to
  313.               delete the whole definition or just the contents
  314.               column data.
  315.  
  316.               o    A MOVE command has been added, allowing the
  317.               reordering of blocks of definitions to make the
  318.               modification of selected data easier.
  319.  
  320.               o    The printed output may be directed to any of
  321.               three printer ports (LPT1:, LPT2:, or LPT3:), and the
  322.               selection can be saved as a system default.
  323.  
  324.               o    The user can set the delay time Formfit! uses
  325.               when generating programmed pauses.  This allows users
  326.               to tailor Formfit! to their CPU's clock rate.
  327.  
  328.               o    The number of definitions-per-form has been made
  329.               dynamically variable, up to a maximum of 999.
  330.  
  331.               o    Variable template and form sizes are now allowed,
  332.               up to 137 columns by 132 rows.  (Automatic selection
  333.               of compressed print mode when more than 80 columns
  334.               across are requested.)
  335.  
  336.               o    Menu response methods have been improved, and
  337.               scrolling bar menus are supplemented by unique letter
  338.               choices.
  339.  
  340.               o    Several parameters can now be customized and
  341.               saved as defaults.  Also, definition files now include
  342.               all system parameters when saved and retrieved.
  343.  
  344.               o    Extensive error trapping and non-destructive
  345.               escape sequences are now available, as well as
  346.               improved error handling and menu logic.
  347.  
  348.               o    Date and Time information is available on screen.
  349.  
  350.               o    A DOS shell allows the user to access DOS, and
  351.               then return to using Formfit!
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.                                      vi
  363.  
  364.  
  365.  Formfit! 3.0
  366.  (C) Copyright 1987, 1988 Sidebar Software
  367.  
  368.  
  369.                                       CONTENTS
  370.  
  371.          WARRANTY  . . . . . . . . . . . . . . . . . . . . . . . . . .  ii.
  372.  
  373.          LICENSE   . . . . . . . . . . . . . . . . . . . . . . . . . . iii.
  374.  
  375.          REGISTRATION INFORMATION  . . . . . . . . . . . . . . . . . .  iv.
  376.  
  377.          ABOUT SIDEBAR SOFTWARE  . . . . . . . . . . . . . . . . . . .  iv.
  378.  
  379.          ABOUT FORMFIT! VERSION 3.0  . . . . . . . . . . . . . . . . .   v.
  380.  
  381.          1.   INTRODUCTION . . . . . . . . . . . . . . . . . . . . . .  1.1
  382.  
  383.                    System Requirements . . . . . . . . . . . . . . . .  1.1
  384.                    Running Formfit! for the First Time . . . . . . . .  1.2
  385.                    Tips on Using Formfit!  . . . . . . . . . . . . . .  1.2
  386.  
  387.  
  388.          2.   THE MAIN MENU SCREEN . . . . . . . . . . . . . . . . . .  2.1
  389.  
  390.                    Define/Edit a Form  . . . . . . . . . . . . . . . .  2.1
  391.                    Print to the Form . . . . . . . . . . . . . . . . .  2.1
  392.                    Make a Template Overlay . . . . . . . . . . . . . .  2.2
  393.                    Check/Change Defaults . . . . . . . . . . . . . . .  2.2
  394.                    Use the DOS Shell . . . . . . . . . . . . . . . . .  2.2
  395.  
  396.  
  397.          3.   CHECKING AND CHANGING SYSTEM DEFAULTS  . . . . . . . . .  3.1
  398.  
  399.                    A. Page Length  . . . . . . . . . . . . . . . . . .  3.1
  400.                    B. Page Width . . . . . . . . . . . . . . . . . . .  3.1
  401.                    C. Maximum Number of Definitions  . . . . . . . . .  3.2
  402.                    D. File Definition Path . . . . . . . . . . . . . .  3.2
  403.                    E. Toggle Date Display  . . . . . . . . . . . . . .  3.2
  404.                    F. Toggle Time Display  . . . . . . . . . . . . . .  3.2
  405.                    G. Toggle Speaker Beep  . . . . . . . . . . . . . .  3.2
  406.                    H. Toggle Paper Out Detector  . . . . . . . . . . .  3.2
  407.                    I. Toggle Unidirectional Printing . . . . . . . . .  3.3
  408.                    J. Toggle Font Selection  . . . . . . . . . . . . .  3.3
  409.                    K. Toggle Printer Port  . . . . . . . . . . . . . .  3.3
  410.                    L. System Message Delay Time  . . . . . . . . . . .  3.3
  411.                    M. Printer Control Codes  . . . . . . . . . . . . .  3.4
  412.  
  413.  
  414.          4.   MAKING TEMPLATE OVERLAYS . . . . . . . . . . . . . . . .  4.1
  415.  
  416.          5.   THE DEFINE/EDIT MODE . . . . . . . . . . . . . . . . . .  5.1
  417.  
  418.                    Edit  . . . . . . . . . . . . . . . . . . . . . . .  5.1
  419.                    Delete  . . . . . . . . . . . . . . . . . . . . . .  5.2
  420.                    Move  . . . . . . . . . . . . . . . . . . . . . . .  5.3
  421.                    Load  . . . . . . . . . . . . . . . . . . . . . . .  5.5
  422.                    Save  . . . . . . . . . . . . . . . . . . . . . . .  5.5
  423.  
  424.                                     vii
  425.  
  426.  
  427.  Formfit! 3.0
  428.  (C) Copyright 1987, 1988 Sidebar Software
  429.  
  430.  
  431.  
  432.  
  433.          6.   PRINTING TO THE FORM . . . . . . . . . . . . . . . . . .  6.1
  434.  
  435.          7.   USING THE DOS SHELL  . . . . . . . . . . . . . . . . . .  7.1
  436.  
  437.  
  438.  
  439.  
  440.          APPENDICES
  441.  
  442.  
  443.          A.   INITIAL DEFAULTS AND DEFAULT FILE STRUCTURE  . . . . . .  A.1
  444.  
  445.          B.   USER REGISTRATION FORM . . . . . . . . . . . . . . . . .  B.1
  446.  
  447.          C.   FORMFIT! ERROR MESSAGES  . . . . . . . . . . . . . . . .  C.1
  448.  
  449.          D.   USING CONVERT.COM ON VERSION 2.x FILES . . . . . . . . .  D.1
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.                                     viii
  487.  
  488.  
  489.  Formfit! 3.0
  490.  (C) Copyright 1987, 1988 Sidebar Software
  491.  
  492.  
  493.  
  494.          1.   INTRODUCTION
  495.  
  496.  
  497.          The purpose of Formfit! is to allow the user to define positions
  498.          and areas on pre-printed forms, place data at any given position on
  499.          the form, and save the definitions and data for later use.  By
  500.          defining commonly used forms once, the user need only update the
  501.          data that has changed since the last session.  This allows updates
  502.          and changes to be made quickly and easily, even when the form's
  503.          basic structure has changed.  The program uses coordinates obtained
  504.          from an overlay template which the user creates on his/her own
  505.          printer (for row and column alignment.)  Many options are allowed
  506.          at print time, such as unidirectional printing to insure columnar
  507.          alignment, selection of several fonts and printer ports, and
  508.          software override of out-of-paper detection (if supported by your
  509.          printer.)
  510.  
  511.  
  512.          System Requirements
  513.  
  514.          Formfit! dynamically allocates memory according to the parameter
  515.          controlling maximum number of allowed definitions. Initially, this
  516.          is set to 255, but may be changed to any value from 1 to 999.  As a
  517.          guide to operation, the following table gives APPROXIMATE memory
  518.          requirements for various configurations.  Values shown below do not
  519.          include memory required to use the DOS shell (that depends on what
  520.          you do while you are working in the DOS environment.)  See chapter
  521.          7 for more details.
  522.  
  523.             Maximum Number of Definitions             Required RAM
  524.             -----------------------------          ------------------
  525.                          50                            180 Kbytes
  526.                         100                            184 Kbytes
  527.                         255                            190 Kbytes
  528.                         500                            200 Kbytes
  529.                         999                            224 Kbytes
  530.  
  531.          WARNING:  Attempting to run Formfit! in less memory than needed
  532.          will usually result in the DOS message "Not Enough Memory," but in
  533.          certain cases Formfit! will begin to run, albeit incorrectly.  Each
  534.          of the above entries is slightly inflated, so following them should
  535.          keep you out of trouble.
  536.  
  537.          In addition to the above RAM requirements, Formfit! needs at least
  538.          one disk drive, a color or monochrome monitor, and a printer.
  539.          Several printer control code sequences are used by the program,
  540.          according to the capabilities of your printer.  The program is
  541.          shipped ready to drive a Panasonic KX-P1091i (in the Epson RX-80
  542.          mode.)  You may define any of those codes which apply to your
  543.          printer, and have Formfit! ignore the rest.  See the section on
  544.          changing defaults, along with your printer and DOS manuals for more
  545.          details.
  546.  
  547.  
  548.                                     1.1
  549.  
  550.  
  551.  Formfit! 3.0
  552.  (C) Copyright 1987, 1988 Sidebar Software
  553.  
  554.  
  555.  
  556.          Running Formfit! for the First Time
  557.  
  558.          As you know, it's good computing practice to back up any program
  559.          before running it, and Formfit! is no exception. Please make an
  560.          archive copy of all files included with the Formfit! package before
  561.          running the program.  Hard disk users may wish to set up a separate
  562.          directory for Formfit!  The program may be invoked by typing
  563.          FORMFIT at the DOS prompt.  Whenever Formfit! is run, it looks at
  564.          the current directory for a file containing the user's default
  565.          parameters.  Since initially this file will be absent (and in case
  566.          it ever gets "misplaced") Formfit! will inform you that it cannot
  567.          find the default file, and will prompt you for your OK before the
  568.          file is actually created on the disk.  Pressing ESC will abort and
  569.          return you to DOS.
  570.  
  571.          Once the default file has been created, you will be presented with
  572.          Formfit!'s registration advertisement.  The first 15 or so times
  573.          you run Formfit!, the ad will appear (the time that Formfit! pauses
  574.          for you to read it decreases each time you run the program.)  When
  575.          prompted, press any key to continue to the Main Menu.  As mentioned
  576.          previously, and as explained in detail in the section on checking
  577.          and changing defaults, Formfit! allows considerable flexibility
  578.          when defining system parameters.  Formfit! comes configured to
  579.          write all form definition files to C:\, the hard drive root
  580.          directory.  If you're using a floppy based system, or wish to use
  581.          your A: or B: drive for saving defined forms, change the File
  582.          Definition Path variable using the Check/Change Defaults option
  583.          from the Main Menu before attempting to save data with Formfit!
  584.  
  585.  
  586.          Tips on Using Formfit!
  587.  
  588.          Formfit! is quite forgiving, and yet it retains an overall
  589.          structured approach to using the various menus and options.  You
  590.          can USUALLY get yourself out of trouble with the ESCape key. ESC is
  591.          used to back up to a previous menu when you're finished at a
  592.          certain level, and if you're in the middle of an operation, ESC
  593.          will abort current processes or changes, and retain previous
  594.          values.
  595.  
  596.          When presented with a highlighted menu bar, use the keypad to move
  597.          and highlight an option, then select it by pressing ENTER.
  598.          Optionally, you may just press the first letter of the option you
  599.          want, and it will be invoked immediately (the commands at each
  600.          level begin with unique letters, which are highlighted.)  In most
  601.          cases the keypad arrows allow movement to the next item, PgUp and
  602.          PgDn move the bar to the last visible item on screen, and Home and
  603.          End will move to the beginning and end, respectively, of a given
  604.          range, even if out of view (range larger than current screen.)
  605.  
  606.          Be sure to configure Formfit! for your printer's capabilities
  607.          before printing templates or forms.  Incorrect codes can make for
  608.          some surprising results, to say the least.
  609.  
  610.                                     1.2
  611.  
  612.  
  613.  Formfit! 3.0
  614.  (C) Copyright 1987, 1988 Sidebar Software
  615.  
  616.  
  617.  
  618.          2.   THE MAIN MENU SCREEN
  619.  
  620.  
  621.          Once the advertisement is finished (or, later, directly upon
  622.          starting Formfit! from DOS) the Main Menu appears.  You will be
  623.          presented with the following choices:
  624.  
  625.  
  626.                                  Define/Edit a Form
  627.                                   Print to the Form
  628.                                Make a Template Overlay
  629.                                 Check/Change Defaults
  630.                                   Use the DOS Shell
  631.                               -------------------------
  632.                                   Press ESC to exit
  633.  
  634.  
  635.          You'll select one of the options from this menu.  The following is
  636.          an overview of each of the Main Menu's options.  For details on
  637.          using each one, see the section pertaining to that area.  They are
  638.          presented in this overview section in the order you see them on the
  639.          Main Menu, and later, in a more detailed discussion, in the order
  640.          that they'll be used by the first time user.
  641.  
  642.  
  643.          Define/Edit a Form
  644.  
  645.          This is where you make the actual additions and changes to a given
  646.          form, or begin to define a new form.  You can add new data, change
  647.          old data, remove previous definitions and/or data, reorder a form's
  648.          definitions and load and save form definitions to and from the
  649.          disk.  You will work in a window, choosing lines of data from the
  650.          screen to modify or edit.  Also, Formfit! tries to anticipate your
  651.          next selection with defaults extracted from the last line you
  652.          filled out.  This is helpful, as many forms are repetitive in
  653.          nature (i.e. all stock numbers begin at column 3.)  A unique
  654.          feature of Formfit! is that entries need not be made in any order,
  655.          so you can define all the items in column 18, for example, before
  656.          defining the items in column 5.  This helps you arrange the form
  657.          logically, grouping the most often changed entries together.
  658.  
  659.  
  660.          Print to the Form
  661.  
  662.          This option is used when its time to actually print the data to the
  663.          defined areas of your preprinted form.  You'll be prompted before
  664.          printing begins to align the printhead with the top of the form.
  665.          When the printing job is complete, you are returned to the Main
  666.          Menu.
  667.  
  668.  
  669.  
  670.  
  671.  
  672.                                     2.1
  673.  
  674.  
  675.  Formfit! 3.0
  676.  (C) Copyright 1987, 1988 Sidebar Software
  677.  
  678.  
  679.  
  680.          Make a Template Overlay
  681.  
  682.          This is the option you select when you wish to print out a template
  683.          guide overlay.  The guide will be sized according to your default
  684.          width and length parameters.  Usually, you will only need to print
  685.          a template once.  Here at Sidebar, we printed out several templates
  686.          using different size options, then had clear plastic copies made of
  687.          them.  This allows us to lay the templates over the forms to be
  688.          defined, and easily read off the coordinates.  Of course, you can
  689.          use paper templates, and align them using a light, but the plastic
  690.          is MUCH easier!  Remember, whatever method you use, MARK AN EASILY
  691.          FOUND REFERENCE POINT ON THE PAPER BEFORE BEGINNING TO PRINT THE
  692.          TEMPLATE.  This is the only way you can insure proper alignment of
  693.          your preprinted form later.  You will be prompted before printing
  694.          begins to align the printhead and the form.  When the printing job
  695.          is complete, you are returned to the Main Menu.
  696.  
  697.  
  698.          Check/Change Defaults
  699.  
  700.          Two screens are associated with this option.  On the first screen,
  701.          you have many choices concerning the program's "feel" and physical
  702.          limits.  For example, you can change the size of the page you
  703.          prefer to work with, allocate more memory (by choosing a larger
  704.          number of definitions,) and toggle on and off things like
  705.          unidirectional printing, or the beeping that accompanies errors and
  706.          undefined key presses.  The delay time associated with error
  707.          messages is adjustable from this screen, too.
  708.  
  709.          The second screen is used for configuring Formfit! to work with
  710.          your printer.  You provide the control codes needed by the printer
  711.          for things such as compressed printing, font selection, and
  712.          ignoring a paper out condition.  Any function not supported by your
  713.          printer may be left blank, and Formfit! will not attempt to use
  714.          that function.
  715.  
  716.  
  717.          Use the DOS Shell
  718.  
  719.          This allows the user to drop down into DOS, execute commands and/or
  720.          run programs, then return to Formfit! when finished.  This can be
  721.          handy for checking the current directory, renaming files, and
  722.          copying files to other disks or directories.  You can even run
  723.          other programs while in the shell, provided you have enough free
  724.          memory.  Refer to chapter 7 for full details on using the DOS
  725.          shell.
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.                                     2.2
  735.  
  736.  
  737.  Formfit! 3.0
  738.  (C) Copyright 1987, 1988 Sidebar Software
  739.  
  740.  
  741.  
  742.          3.   CHECKING AND CHANGING SYSTEM DEFAULTS
  743.  
  744.  
  745.          This section begins the detailed descriptions of Formfit's menus
  746.          and options.  These sections are organized according to the order
  747.          in which a first time user will use Formfit!  For this reason, the
  748.          first order of business is to change the system defaults to match
  749.          your system and suit your tastes.  The system defaults are found on
  750.          two screens.  The first screen controls page layout, printer
  751.          toggles, etc., and will be used quite often.  It is shown when you
  752.          select the Check/Change Defaults option from the Main Menu.  The
  753.          second screen, however, will usually be used only when you change
  754.          printers, and is reached through the first screen by selecting the
  755.          Printer Control Codes option (currently selection M.)
  756.  
  757.          To change any item on either screen, press the letter of its
  758.          choice.  You may ESCape at any time.  All the information (from
  759.          both screens) will be used only during the current session, unless
  760.          saved to disk, where it becomes the new default data for subsequent
  761.          program runs.  Saving is done FROM THE FIRST SCREEN by pressing S
  762.          instead of a lettered menu option.  See Appendix A. for a
  763.          discussion of the original Formfit! defaults.  Each option is
  764.          explained below.
  765.  
  766.  
  767.          A. Page Length
  768.  
  769.          This allows you to define the length of the form you will be using.
  770.          This length is specified by giving the number of lines per page.
  771.          You may set the page length to any number of lines (rows) from 1 to
  772.          132.  If you work with forms larger than 132 lines, you may have to
  773.          define it in parts (or write to us about a "custom" version of
  774.          Formfit!)
  775.  
  776.  
  777.          B. Page Width
  778.  
  779.          The page width can be set to any number of columns from 5 to 137.
  780.          If your printer does not support condensed printing, limit your
  781.          page width to 80 columns, as Formfit! will attempt to turn on
  782.          condensed printing when the page width is greater than 80.  Of
  783.          course, if you use a 132 column printer, set the condensed print
  784.          mode control code sequence to N/A, and wide forms will be filled
  785.          out using normal sized fonts.  Note: On some printers, different
  786.          fonts may automatically invoke proportional spacing.  Since
  787.          Formfit! has no way of knowing how "smart" your printer is, when
  788.          using fonts other than draft, experiment on blank paper first
  789.          before inserting your only copy of that important form!
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.                                     3.1
  797.  
  798.  
  799.  Formfit! 3.0
  800.  (C) Copyright 1987, 1988 Sidebar Software
  801.  
  802.  
  803.  
  804.          C. Maximum Number of Definitions
  805.  
  806.          This option allows you to dynamically allocate how much memory
  807.          Formfit! will use at run time.  You can select any amount in the
  808.          range of 1 to 999.  The more definitions you allow for (whether or
  809.          not you use them,) the more RAM you'll need.  When you select this
  810.          option, ANY DEFINITIONS YOU CURRENTLY HAVE IN MEMORY WILL BE LOST,
  811.          so save them first.  You'll be prompted before any data is actually
  812.          lost, so you can ESCape unharmed if you need to.
  813.  
  814.  
  815.          D. File Definition Path
  816.  
  817.          Use this option to change the path which DOS uses to save and load
  818.          defined forms.  When changing this item, you should end your path
  819.          with the backslash (\) character (if you don't, though, Formfit!
  820.          will supply it for you.)  You are limited to 32 characters for the
  821.          complete path information.  The original default is C:\, the hard
  822.          drive root directory.
  823.  
  824.  
  825.          E. Toggle Date Display
  826.          F. Toggle Time Display
  827.          G. Toggle Speaker Beep
  828.  
  829.          Options E., F., and G. are used to toggle on and off the current
  830.          date, time, and error beep respectively.  When toggled on, the date
  831.          is displayed in the upper left corner of all menus, and the time is
  832.          displayed in the upper right.  These are the date and time
  833.          currently maintained by DOS, so if you don't normally set these at
  834.          boot time (or your clock has no battery,) you may just want to
  835.          toggle these off, and save the new defaults to disk.  The beep
  836.          toggle is used to turn on/off the error beep that occurs whenever
  837.          Formfit! encounters a bad keypress or displays an error message.
  838.  
  839.  
  840.          H. Toggle Paper Out Detector
  841.  
  842.          This will enable or disable the printer's paper out sensor.  (Your
  843.          printer must allow software control of this mode for Formfit! to
  844.          toggle the paper out sensor on and off.)  Many forms need to be
  845.          filled out to very near the bottom edge of the page, and if the
  846.          printer isn't told to ignore the end-of-paper signal, it will
  847.          usually halt printing about 13 lines from the bottom of the form.
  848.          By disabling the paper out sensor, you can usually print completely
  849.          to the last line on a form (depending, again, on your printer's
  850.          mechanical paper bail and feed arrangement.)
  851.  
  852.  
  853.  
  854.  
  855.  
  856.  
  857.  
  858.                                     3.2
  859.  
  860.  
  861.  Formfit! 3.0
  862.  (C) Copyright 1987, 1988 Sidebar Software
  863.  
  864.  
  865.  
  866.          I. Toggle Unidirectional Printing
  867.  
  868.          As the name says, this option toggles unidirectional printing on
  869.          and off.  Many printers have some alignment trouble when using
  870.          bidirectional printing with condensed mode fonts.  By forcing
  871.          unidirectional printing, columns will be aligned quite nicely.
  872.          Test your printer by printing a short template guide with more than
  873.          80 columns, first using bidirectional, and then unidirectional
  874.          printing.  Save the defaults when you have made your selection.
  875.  
  876.  
  877.          J. Toggle Font Selection
  878.  
  879.          Use this option to select between three available fonts: Draft,
  880.          Courier NLQ (Near Letter Quality), and Bold PS NLQ.  These may not
  881.          be available on your printer, so be sure to change to the correct
  882.          control code sequence, using the second System Defaults screen (see
  883.          Printer Control Codes, Option M. below.)  In any case, pressing J.
  884.          will toggle between the three options.
  885.  
  886.  
  887.          K. Toggle Printer Port
  888.  
  889.          Formfit! can direct the output to be printed to any of three
  890.          printer ports.  These ports are referred to as LPT1:, LPT2:, and
  891.          LPT3:.  The default is LPT1:, but you can toggle to any of the
  892.          three and then save your defaults.
  893.  
  894.  
  895.          L.  System Message Delay Time
  896.  
  897.          Here is where you control how long Formfit! pauses to let you read
  898.          messages.  Some warnings require you to press a key to continue
  899.          operation of the program, while others just beep (if the beep
  900.          toggle is enabled) and pause an appropriate amount of time before
  901.          returning you to the main program.  You are allowed to choose a
  902.          delay of 1 to 20  (10 is the default.)  This delay number is
  903.          somewhat arbitrary, depending on your particular system.  One
  904.          "unit" of delay causes an approximate pause of 1/2 second on a unit
  905.          running with a CPU clock speed of 8 Mhz.  Don't worry if you don't
  906.          know how fast the computer's clock speed is - just set the delay so
  907.          that you have time to read the error messages!  (Note:  This delay
  908.          doesn't effect the initial advertisement time.  That changes as a
  909.          function of the number of times Formfit! has been run, and finally
  910.          quits altogether.)
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.                                     3.3
  921.  
  922.  
  923.  Formfit! 3.0
  924.  (C) Copyright 1987, 1988 Sidebar Software
  925.  
  926.  
  927.  
  928.          M. Printer Control Codes
  929.  
  930.          Choosing option M. will show the second Check/Change Defaults
  931.          screen.  This is where you define the needed printer control code
  932.          sequences for Formfit!  Each sequence may consist of several codes,
  933.          which can be found in the user's manual for your printer.  Have the
  934.          printer manual handy before attempting to change any codes.
  935.  
  936.          You select an option by pressing its corresponding letter (or you
  937.          can ESCape.)  Formfit! will prompt you for a string of DECIMAL
  938.          printer codes, which you must separate by a single space.  If a
  939.          particular option is not supported by your printer, select that
  940.          option to modify (by pressing its corresponding menu letter,) and
  941.          immediately press ENTER (i.e. supply NO codes.)  This will cancel
  942.          any previous control code sequence, and display N/A next to the
  943.          option.  This will signal Formfit! not to attempt to use that
  944.          option.  When you are done with this screen, use ESC to return to
  945.          the first screen, where you may save the defaults to disk (by
  946.          pressing the letter "S",) or use ESC again to return to the Main
  947.          Menu, keeping the newly changed defaults only for the current
  948.          Formfit! session.
  949.  
  950.          Note:  Option A. (Current Printer) of this second screen is used to
  951.          specify which printer your system currently uses.  This is for your
  952.          information only.  No check is made as to what type of printer you
  953.          specify here.  The name (or whatever else you care to type in) is
  954.          just to remind you which type of printer the codes are set for.
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.                                     3.4
  983.  
  984.  
  985.  Formfit! 3.0
  986.  (C) Copyright 1987, 1988 Sidebar Software
  987.  
  988.  
  989.  
  990.          4.   MAKING TEMPLATE OVERLAYS
  991.  
  992.  
  993.          The heart of the Formfit! system is the template overlay.  The
  994.          template is how you let Formfit! know where to place data at print
  995.          time.
  996.  
  997.          The template is made up of several rows and columns.  Remember,
  998.          sentences on a page are in ROW order, and COLUMNS go up and down.
  999.          Each row begins at the left, with column position 1.  So the
  1000.          leftmost upper corner print position is at row 1, column 1.  The
  1001.          16th row of a typical template might look like this:
  1002.  
  1003.              16.._....1...._....2...._....3...._....4...._....5...._.
  1004.  
  1005.          Notice how the line is constructed.  The row number is given fully
  1006.          as the first number in the line.  Each column is marked with a dot,
  1007.          and if the column is a multiple of 5, it's marked with an
  1008.          underscore symbol (_).  Columns that are multiples of 10 are marked
  1009.          with the tens digit of that column.  For example, the 40th column
  1010.          position is indicated by the "4" in the line above.   Note also
  1011.          that the user has requested the maximum number of columns to be 56.
  1012.  
  1013.          You must make at least one template overlay before using Formfit!
  1014.          Your forms will be defined by means of a row and column matrix, and
  1015.          those references must be easily found.  This is where the template
  1016.          comes in.  Initially, you align the template with your form and
  1017.          begin to define your form using the coordinates read from the
  1018.          overlay to reference different areas of the form.
  1019.  
  1020.          When you select the Make a Template Overlay option, you're prompted
  1021.          to align your printhead and paper before proceeding (you may ESCape
  1022.          of course.)  It's also important that you MARK THE BLANK PAPER WITH
  1023.          AN INDEX MARK of some kind, so the physical position of the paper
  1024.          in the printer can be found again later.  On the Panasonic we use
  1025.          at Sidebar, the paper bail is marked with index marks, so we just
  1026.          position the corner of the page at the zero mark (you may have to
  1027.          use some other landmark, or make a pencil mark, etc., to mark a
  1028.          position on the paper.)  In any case, a template without some sort
  1029.          of printer alignment reference point is practically useless.
  1030.  
  1031.          Next, you press any key to print out the template, and are returned
  1032.          to the Main Menu when finished.  (You may abort the template
  1033.          printing operation at any time by pressing ESC.)  Make a few
  1034.          templates of various widths and lengths.  We also recommend getting
  1035.          them copied onto plastic.  This can be done at most copy services.
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.                                     4.1
  1045.  
  1046.  
  1047.  Formfit! 3.0
  1048.  (C) Copyright 1987, 1988 Sidebar Software
  1049.  
  1050.  
  1051.  
  1052.          5.   THE DEFINE/EDIT MODE
  1053.  
  1054.  
  1055.          This is by far the most used screen in Formfit!  The information is
  1056.          presented in a 13 line window, and consists of the definition
  1057.          number, a label (for your convenience only,) the definition's row,
  1058.          its starting and ending (inclusive) column numbers, and the data
  1059.          which is to be placed at that position on the preprinted form at
  1060.          print time (called "Contents".)  You can scroll up and down one
  1061.          page of definitions at a time, using the PgUp and PgDn keys, or go
  1062.          directly to the first or last definition, using the Home and End
  1063.          keys.  There is an overlap of one definition when you change pages.
  1064.          In other words, the first page will show definitions 1 through 13,
  1065.          and the second page (if there are more than 13 definitions) will
  1066.          begin with number 13.  At the bottom of the Define/Edit screen, you
  1067.          can see a menu bar, as shown below:
  1068.  
  1069.                           Edit   Delete   Move   Load   Save
  1070.  
  1071.          Initially, the Edit option will be highlighted.  The horizontal
  1072.          arrow keys are used to move the highlight to other options, and
  1073.          ENTER will select an option.  You may also select an option by
  1074.          pressing the first letter of the option's name.  ESC returns you to
  1075.          the Main Menu. Details on using each of the menu bar options
  1076.          follows.
  1077.  
  1078.  
  1079.          Edit
  1080.  
  1081.          Selecting Edit allows you to define a new entry, or modify an
  1082.          existing one.  An editing window will be opened, and you will be
  1083.          allowed to fill in the needed information.  To the left of each
  1084.          line of information is the default data (in brackets) for that
  1085.          entry.  This is usually what was given for the previous definition.
  1086.          Pressing ENTER alone will select the default value.  Typical edit
  1087.          window data is shown below, and is followed by a line by line
  1088.          explanation of its use.
  1089.  
  1090.               [ 3 ] Definition Number to Edit:  3
  1091.                                  [Name] Label:  Address
  1092.                                     [ 1 ] Row:  3
  1093.                            [ 4 ] Column Start:  4
  1094.                             [ 20 ] Column End:  36
  1095.                [Stevens, William J.] Contents:  107 N. Mill Lane Rd.
  1096.  
  1097.  
  1098.          The default value for Definition Number to Edit is the next unused
  1099.          entry, regardless of which item was last edited.  For example, if
  1100.          you had already defined 55 entries, and then edited number 32, the
  1101.          next default for Number to Edit would be 56.  Error checking
  1102.          prevents you from selecting a value of less than one, or greater
  1103.          than the next available definition.  The default reads [FULL] when
  1104.          you have used all definitions.
  1105.  
  1106.                                     5.1
  1107.  
  1108.  
  1109.  Formfit! 3.0
  1110.  (C) Copyright 1987, 1988 Sidebar Software
  1111.  
  1112.  
  1113.  
  1114.          The Label entry is for your own reference only.  By using the name
  1115.          of the entry given on the form, such as NAME or ADDRESS, you can
  1116.          easily locate items which must be changed when you re-edit a form
  1117.          at some later date.  The default for this entry is the last
  1118.          definition's Label value.  Enter a blank space if no label name is
  1119.          to be associated with an entry.  Labels are limited to 20
  1120.          characters maximum.
  1121.  
  1122.          Row, Column Start, and Column End are self explanatory, with the
  1123.          defaults being the last defined entry's Row and Column values.
  1124.          Error checking is performed on boundaries, according to form length
  1125.          and width.
  1126.  
  1127.          The Contents entry is where you provide the data to be printed on
  1128.          the form itself.  You are limited in length by the column start and
  1129.          column end values previously entered.  In any case, a maximum of 31
  1130.          characters are allowed.  To use more than this you must define a
  1131.          definition in parts.  The default is the last definition's Contents
  1132.          value.  One suggestion: Group together items on the form which will
  1133.          be changed each time the form is filled out.  Then use the
  1134.          characters <NEEDED> for the contents of these definitions.  Later,
  1135.          when filling out the contents, others can load in the form and use
  1136.          the Delete option (see below) to delete just these contents values.
  1137.          This lets others know just which columns you want them to fill out.
  1138.  
  1139.  
  1140.          Delete
  1141.  
  1142.          Use this option to delete form data.  You may delete one or more
  1143.          whole definitions, or just the contents of those definitions.  When
  1144.          you choose this option, a window will appear, and you will be given
  1145.          two choices:  Contents Column Only or Whole Definition.  Choosing
  1146.          Contents Column Only will cause the data in the contents column of
  1147.          each specified definition to be erased.  Choosing Whole Definition
  1148.          will erase the entire definition (moving down all higher numbered
  1149.          definitions to "fill in the gap".)
  1150.  
  1151.          Depending on which you've decided to delete (Contents Column Only
  1152.          or Whole Definition), you'll be asked to give a range of definition
  1153.          numbers for Formfit! to operate on.  Give the FROM value first,
  1154.          press ENTER, and then give a value for TO (you can ESC any time.)
  1155.          Error checking will be performed to insure you've chosen a valid
  1156.          range, and the appropriate action will be taken.  To delete a
  1157.          single definition (or its contents) choose the same number for the
  1158.          FROM and TO values (i.e.  ... from:  5   to:  5    will delete just
  1159.          definition number 5.)
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.                                     5.2
  1169.  
  1170.  
  1171.  Formfit! 3.0
  1172.  (C) Copyright 1987, 1988 Sidebar Software
  1173.  
  1174.  
  1175.  
  1176.          Move
  1177.  
  1178.          The Move option allows you to move your definitions around in
  1179.          relationship to each other.  This doesn't affect the definition's
  1180.          values or coordinates, but merely lets you shuffle the order in
  1181.          which the definitions appear to the user.  You can move up to 100
  1182.          definitions at a time.  When you choose to Move definitions, you
  1183.          get the prompt:
  1184.  
  1185.               Insert Just Before Number:
  1186.  
  1187.          You supply the number of the definition you want the block to be
  1188.          inserted in front of.  For example, if you want the block of
  1189.          definitions from 24 to 30 to be inserted between definitions 3 and
  1190.          4, you would respond with the number 4 here.
  1191.  
  1192.          After giving the definition number where the block is to be
  1193.          inserted (and hitting ENTER,) you'll see the rest of the prompt:
  1194.  
  1195.               Insert Just Before Number:  4    the Range from:      to:
  1196.  
  1197.          In our example, you would supply the numbers 24 (from) and 30 (to)
  1198.          at this time.  Press ENTER after each entry, or ESC to abort.
  1199.          Error checking will be performed to insure a valid range and
  1200.          insertion point, and the operation will be carried out.
  1201.  
  1202.          Note:  A few words of warning are in order here.  When moving
  1203.          blocks of definitions, move blocks to LOWER positions, i.e. toward
  1204.          definition number one.  Moving blocks to higher positions can be
  1205.          confusing, to both you and Formfit!  An example will help clarify
  1206.          this.
  1207.  
  1208.          Consider the structure below.  The numbers represent definition
  1209.          numbers, and the letters represent the rest of a given definition.
  1210.  
  1211.  
  1212.                                  1       A
  1213.                                  2       B
  1214.                                  3       C
  1215.                                  4       D
  1216.                                  5       E
  1217.                                  6       F
  1218.                                  7       G
  1219.                                  8       H
  1220.                                  9       I
  1221.                                 10       J
  1222.  
  1223.  
  1224.          If you desired to move definitions 4, 5, and 6 to a point between
  1225.          definitions 7 and 8, what you would expect and what you would
  1226.          actually get are both shown on the following page.
  1227.  
  1228.  
  1229.  
  1230.                                     5.3
  1231.  
  1232.  
  1233.  Formfit! 3.0
  1234.  (C) Copyright 1987, 1988 Sidebar Software
  1235.  
  1236.  
  1237.  
  1238.          The command would be:
  1239.  
  1240.            Insert Just Before Number:  8    the Range from:  4   to:  6
  1241.  
  1242.          and the Before, Desired, and Actual results are:
  1243.  
  1244.  
  1245.                   1     A           1     A           1     A
  1246.                   2     B           2     B           2     B
  1247.                   3     C           3     C           3     C
  1248.                   4     D           4     G           4     G
  1249.                   5     E           5     D           5     H
  1250.                   6     F           6     E           6     I
  1251.                   7     G           7     F           7     J
  1252.                   8     H           8     H           8     D
  1253.                   9     I           9     I           9     E
  1254.                  10     J          10     J          10     F
  1255.  
  1256.                   Before            Desired             Actual
  1257.  
  1258.  
  1259.          You wanted to move the letters D, E, and F to the point in between
  1260.          G and H, but Formfit! didn't come across for you!  What's the
  1261.          problem?  Well, the problem is in the algorithm used to move blocks
  1262.          of definitions around.  Formfit! first saves the block you want to
  1263.          move in temporary storage.  Then the rest of the definitions are
  1264.          "moved back" toward definition number one, covering up the original
  1265.          block.  Next a hole is created just before the number you wanted to
  1266.          insert the block behind (behind being toward definition number
  1267.          one), and the temporarily stored definitions are inserted in this
  1268.          hole.
  1269.  
  1270.          This approach works fine for moving blocks backward, toward
  1271.          definition number one, but not forward (at least not in all cases.)
  1272.          The fix is to understand that every forward movement has a
  1273.          complimentary backward movement, and to use this complimentary
  1274.          movement.  For example, had you taken definition 7 in the example
  1275.          above and inserted it just before definition 4, the result would
  1276.          have been what you wanted.  Until you get used to moving blocks
  1277.          with Formfit!, save your definitions just before you try a move.
  1278.          But don't be afraid to experiment either.  Make up a few test files
  1279.          and practice using the Move command.  It's too powerful not to
  1280.          master.
  1281.  
  1282.  
  1283.  
  1284.  
  1285.  
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.  
  1292.                                     5.4
  1293.  
  1294.  
  1295.  Formfit! 3.0
  1296.  (C) Copyright 1987, 1988 Sidebar Software
  1297.  
  1298.  
  1299.  
  1300.          Load
  1301.  
  1302.          When you select Load, the screen clears, and a list of all the
  1303.          definition files on the current directory is given, or you are
  1304.          informed that no definition files exist.  (Definition files end in
  1305.          .DEF, and this is how they are found.)  You are then prompted for a
  1306.          filename.  Formfit! will supply the extension of .DEF to the
  1307.          filename, so you are limited to eight characters for the filename.
  1308.          If you do append an extension, Formfit! will merely truncate it and
  1309.          add the .DEF extension.  Remember, the default path information
  1310.          will be used to find the file, so DO NOT USE ANY PATH INFORMATION
  1311.          when specifying a file to load in.  You may select the default
  1312.          filename by pressing ENTER without supplying any name.  The default
  1313.          is either the last filename loaded or saved, or, if no files have
  1314.          been accessed yet, TEMPFILE.DEF is used as the default.  Since the
  1315.          Save option saves the current defaults with a file, the defaults
  1316.          may be different when loading is finished.  When loading is
  1317.          completed, you are returned to the Define/Edit screen.
  1318.  
  1319.  
  1320.          Save
  1321.  
  1322.          Save is very much like Load.  You are given a list of files on the
  1323.          current directory, and then prompted for the name of the file to be
  1324.          saved.  (Again, if no definition files exist on the current
  1325.          directory, you are told so.)  The .DEF extension will be
  1326.          automatically appended, and the default filename is used if only
  1327.          ENTER is pressed.  See Load above for an explanation of filename
  1328.          defaults.  Remember, all system defaults currently in effect will
  1329.          be saved along with the file.
  1330.  
  1331.  
  1332.  
  1333.  
  1334.  
  1335.  
  1336.  
  1337.  
  1338.  
  1339.  
  1340.  
  1341.  
  1342.  
  1343.  
  1344.  
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.  
  1351.  
  1352.  
  1353.  
  1354.                                     5.5
  1355.  
  1356.  
  1357.  Formfit! 3.0
  1358.  (C) Copyright 1987, 1988 Sidebar Software
  1359.  
  1360.  
  1361.  
  1362.          6.   PRINTING TO THE FORM
  1363.  
  1364.  
  1365.          Use this option when it is time to print out the information on the
  1366.          form itself.  First, you will be asked to align the form and the
  1367.          printhead.  Do this by marking the form (if necessary) using the
  1368.          template guide's alignment mark.  In other words, align the
  1369.          template with the form, mark a spot on the form corresponding to
  1370.          the alignment mark on the template, roll the form into the printer,
  1371.          and align the mark that is now on the form with the index on the
  1372.          printer itself (i.e. the one you used when you printed the template
  1373.          guide.)  Then press ENTER to begin the printing process (or ESCape
  1374.          to abort.)  When printing is finished, you will be returned to the
  1375.          Main Menu.  You may press ESC at any time during the printing
  1376.          process to abort.  Formfit! will finish printing the current line
  1377.          before aborting the printing process.  Formfit! doesn't attempt to
  1378.          flush your printer's RAM buffer, if one exists.
  1379.  
  1380.          Formfit! can sense several printer errors, such as a paper out
  1381.          condition or the printer being off line.  It will warn you that an
  1382.          error has occurred, and prompt you to either press ESC to abort, or
  1383.          press any other key to retry the operation (after you've corrected
  1384.          the source of the error, of course.)
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.  
  1392.  
  1393.  
  1394.  
  1395.  
  1396.  
  1397.  
  1398.  
  1399.  
  1400.  
  1401.  
  1402.  
  1403.  
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.  
  1410.  
  1411.  
  1412.  
  1413.  
  1414.  
  1415.  
  1416.                                     6.1
  1417.  
  1418.  
  1419.  Formfit! 3.0
  1420.  (C) Copyright 1987, 1988 Sidebar Software
  1421.  
  1422.  
  1423.  
  1424.          7.   USING THE DOS SHELL
  1425.  
  1426.  
  1427.          As discussed earlier, the DOS shell allows you to drop down into
  1428.          the DOS environment, use DOS as you normally would, and return to
  1429.          Formfit! at the point where you left off.  While this is a powerful
  1430.          feature of Formfit!, you must use caution while in DOS, and return
  1431.          to Formfit! properly, as discussed below.
  1432.  
  1433.          To access DOS from Formfit!, you select the Use DOS Shell option
  1434.          from the Main Menu.  You will be presented with an information box,
  1435.          and prompted to press any key to continue.  If you do not wish to
  1436.          continue on into DOS, pressing ESCape will return you to the Main
  1437.          Menu immediately.
  1438.  
  1439.          In order to use DOS, Formfit! must load a second copy of the DOS
  1440.          COMMAND.COM file into memory (the first copy was loaded
  1441.          automatically when you booted up your computer.)  COMMAND.COM is
  1442.          the DOS file that allows you and DOS to communicate with each
  1443.          other.  (Don't worry if this doesn't make perfect sense, as
  1444.          Formfit! handles all the details of loading COMMAND.COM and getting
  1445.          you into the DOS environment.)  Remember, though, that your
  1446.          computer must have sufficient memory to allow the second
  1447.          COMMAND.COM file to be loaded (approximately 24 Kbytes, depending
  1448.          on your version of DOS,) and there must be enough space for any
  1449.          extra programs you wish to run while using the shell.
  1450.  
  1451.          Once the familiar DOS prompt appears, you may do just about
  1452.          anything you would normally do from DOS, including running other
  1453.          programs.  Do not, however, run a program that is to remain
  1454.          resident in the computer (i.e. any of those handy "pop-up"
  1455.          programs.)  If loaded from within the shell, resident programs will
  1456.          not work properly when you return to Formfit!  (They will work fine
  1457.          with Formfit!, but must be loaded BEFORE running Formfit!)
  1458.  
  1459.          Also, if the current DOS directory is changed while using the
  1460.          shell, you should change it back to the directory which Formfit!
  1461.          was using before the shell was invoked.  While the definition files
  1462.          are pathed to a certain directory, the same cannot be said for the
  1463.          default file (FORMFIT.DFL) which Formfit! uses to store your
  1464.          desired default parameter values.  This means that if you change
  1465.          directories while in the shell, then return to Formfit! and change
  1466.          and save the defaults, they will be on a different directory than
  1467.          Formfit! used when it was initially run.  The next time you run
  1468.          Formfit! the new defaults will not be found!
  1469.  
  1470.          To return to Formfit! after using the DOS shell, simply type the
  1471.          command EXIT at the DOS prompt.  You will be immediately returned
  1472.          to the Main Menu of Formfit!, where you may continue working where
  1473.          you left off.
  1474.  
  1475.  
  1476.  
  1477.  
  1478.                                     7.1
  1479.  
  1480.  
  1481.  Formfit! 3.0
  1482.  (C) Copyright 1987, 1988 Sidebar Software
  1483.  
  1484.  
  1485.  
  1486.                                     APPENDIX A.
  1487.  
  1488.  
  1489.                     INITIAL DEFAULTS AND DEFAULT FILE STRUCTURE
  1490.  
  1491.          Formfit! uses default parameters for several of its features.
  1492.          These parameters are stored in a file named FORMFIT.DFL, which is
  1493.          always located ON THE CURRENT DIRECTORY.  If the file FORMFIT.DFL
  1494.          does not exist on the current directory, Formfit! will create it.
  1495.          Formfit! will use certain values when it creates this file, and
  1496.          they are listed below.  Note that numbers shown as <27><53> are
  1497.          actually ASCII characters represented by the decimal numbers in the
  1498.          brackets.  The file on disk will contain the actual ASCII character
  1499.          itself.  When editing this file with a word processor or text
  1500.          editor, remember that numeric data stored in the file will have a
  1501.          leading minus sign, if negative, or a leading blank space if
  1502.          positive.
  1503.  
  1504.           Actual Contents (ASCII)              Remarks (Not part of file)
  1505.          -------------------------            ----------------------------
  1506.           3                                      Major Version Number
  1507.           0                                      Minor Revision Number
  1508.           0                                      (Reserved for future use)
  1509.           0                                      (Reserved for future use)
  1510.           0                                      (Reserved for future use)
  1511.           0                                      (Reserved for future use)
  1512.           0                                      (Reserved for future use)
  1513.           0                                      (Reserved for future use)
  1514.           10                                     Delay Number
  1515.           1                                      Printer Port (1,2 or 3)
  1516.           63                                     Page Length
  1517.           80                                     Page Width
  1518.           255                                    Max Number of Definitions
  1519.          C:\                                     File Definition Path
  1520.          -1                                      Date Toggle          (on)
  1521.          -1                                      Time Toggle          (on)
  1522.          -1                                      Speaker Beep Toggle  (on)
  1523.           0                                      Paper Out Detector   (off)
  1524.           0                                      Unidirectional Print (off)
  1525.          Panasonic KX-P1091i                     Printer Name
  1526.          <27><64>                                Reset Control Codes
  1527.          <27><85><49>                            Unidirectional ON Codes
  1528.          <27><85><48>                            Unidirectional OFF Codes
  1529.          <15>                                    Compressed ON Code
  1530.          <18>                                    Compressed OFF Code
  1531.          <27><57>                                Paper-Out Sense ON Code
  1532.          <27><56>                                Paper-Out Sense OFF Code
  1533.          <27><120><48>                           Draft Font Codes
  1534.          <27><120><49>                           Courier NLQ Font Codes
  1535.          <27><120><50>                           Bold PS NLQ Font Codes
  1536.           1                                      Font Selection: 1=Draft,
  1537.          <End of File>                                  2=Courier, 3=Bold
  1538.  
  1539.  
  1540.                                     A.1
  1541.  
  1542.  
  1543.  Formfit! 3.0
  1544.  (C) Copyright 1987, 1988 Sidebar Software
  1545.  
  1546.  
  1547.          In addition to getting parameter information from the default
  1548.          parameters file, each time a definition file is saved, the
  1549.          currently active parameters are saved along with the file.  The
  1550.          structure of a simple definition file is shown below.
  1551.  
  1552.           3                                              .
  1553.           0                                              .
  1554.           0                                              .
  1555.           0                                              .
  1556.           0                                              .
  1557.           0                                              .
  1558.           0                                              .
  1559.           0                                              .
  1560.           10                                             .
  1561.           1
  1562.           50                                     Defaults are saved first,
  1563.           80                                     and are in the same order
  1564.           100                                    as the defaults found in
  1565.          C:\formfit\files\                       the FORMFIT.DFL file. See
  1566.          -1                                      above for details on this
  1567.          -1                                      portion of the file.
  1568.          -1                                              .
  1569.           0                                              .
  1570.           0                                              .
  1571.          Panasonic KX-P1091i                             .
  1572.          <27><64>                                        .
  1573.          <27><85><49>                                    .
  1574.          <27><85><48>                                    .
  1575.          <15>                                            .
  1576.          <18>                                            .
  1577.          <27><57>                                        .
  1578.          <27><56>                                        .
  1579.          <27><120><48>                                   .
  1580.          <27><120><49>                                   .
  1581.          <27><120><50>                                   .
  1582.           1                                      Last default (Font select)
  1583.          Name                                    Label #1
  1584.          James Clerk Maxwell                     Data for definition #1
  1585.           1                                      Row for #1's data
  1586.           1                                      Column start for #1
  1587.           30                                     Column end for #1
  1588.          Occupation                              Label #2
  1589.          Scientist                               Data for definition #2
  1590.           1                                      Row for #2's data
  1591.           66                                     Column start for #2
  1592.           79                                     Column end for #2
  1593.           .                                               .
  1594.           .                                               .
  1595.           .                                      <Continued as needed>
  1596.           .                                               .
  1597.           .                                               .
  1598.  
  1599.  
  1600.  
  1601.  
  1602.                                     A.2
  1603.  
  1604.  
  1605.  Formfit! 3.0
  1606.  (C) Copyright 1987, 1988 Sidebar Software
  1607.  
  1608.  
  1609.          There may be a need to modify the defaults stored with a definition
  1610.          file.  For example, if you are defining a form, and you discover
  1611.          that not enough definitions were allowed for, you can't increase
  1612.          that number without losing all the data in memory.  And if you save
  1613.          the data first and then increase the maximum number of definitions,
  1614.          when you reload the file the old value for maximum number of
  1615.          definitions is also loaded and used.  In a case like this, you MUST
  1616.          use a text editor to modify the maximum number of definitions
  1617.          parameter in the saved definitions file before reloading.  Use
  1618.          caution, however, so that no limitations are exceeded, which could
  1619.          introduce errors when the file is reloaded.  Also, you should make
  1620.          a backup of the file BEFORE you attempt to modify it.
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.  
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.  
  1656.  
  1657.  
  1658.  
  1659.  
  1660.  
  1661.  
  1662.  
  1663.  
  1664.                                     A.3
  1665.  
  1666.  
  1667.  Formfit! 3.0
  1668.  (C) Copyright 1987, 1988 Sidebar Software
  1669.  
  1670.  
  1671.                                     APPENDIX B.
  1672.  
  1673.  
  1674.                               USER REGISTRATION FORM
  1675.  
  1676.  
  1677.          Use the following form to request the most recent version of
  1678.          Formfit! and to register your copy.  Thank you again from all of us
  1679.          at Sidebar Software.  If you correspond without using the form,
  1680.          please include the information requested below in your letter.
  1681.  
  1682.  
  1683.               Send to:  Formfit!
  1684.                         Sidebar Software
  1685.                         103 Inglewood Circle
  1686.                         Tullahoma, TN  37388
  1687.  
  1688.  
  1689.          ===================================================================
  1690.                           FORMFIT! V3.0 Registration Form
  1691.          ===================================================================
  1692.  
  1693.  
  1694.          Quantity                                                    Total
  1695.  
  1696.  
  1697.          _______   Formfit! Disk (latest version 3.0)   $ 6.00 ea. $ ______
  1698.                    Note: If you haven't registered, this does NOT
  1699.                    include registration.
  1700.  
  1701.          _______   Registration ONLY.                  $ 20.00 ea. $ ______
  1702.  
  1703.          _______   Registration plus latest version.   $ 25.00 ea. $ ______
  1704.  
  1705.  
  1706.          Please note:  We accept only checks or money orders as payment.
  1707.                        No C.O.D. orders will be processed.
  1708.  
  1709.  
  1710.             Name:    ______________________________________________________
  1711.  
  1712.          Address:    ______________________________________________________
  1713.  
  1714.                      ______________________________________________________
  1715.  
  1716.                      _____________________________________ Zip: ___________
  1717.  
  1718.  
  1719.            Phone:    _________________  Add you to our mailing list?   Y  N
  1720.  
  1721.  
  1722.  
  1723.  
  1724.  
  1725.  
  1726.                                     B.1
  1727.  
  1728.  
  1729.  Formfit! 3.0
  1730.  (C) Copyright 1987, 1988 Sidebar Software
  1731.  
  1732.  
  1733.  
  1734.                                     APPENDIX C.
  1735.  
  1736.  
  1737.                               FORMFIT! ERROR MESSAGES
  1738.  
  1739.  
  1740.          Formfit! can detect many of the standard DOS errors pertaining to
  1741.          peripheral devices.  The following is a list of the specific errors
  1742.          Formfit! looks for when requesting disk and/or printer service from
  1743.          DOS.  All other errors not listed below will usually result in
  1744.          Formfit! returning to the Main Menu, although it is possible (if
  1745.          you work at it) to get Formfit! to just forget everything and
  1746.          either return to DOS unexpectedly, or maybe even lock up your
  1747.          machine.
  1748.  
  1749.  
  1750.  
  1751.  
  1752.               Error Number                  Message Displayed
  1753.             ----------------             --------------------------
  1754.                    24                       DEVICE TIMEOUT
  1755.                    25                       PRINTER NOT RESPONDING
  1756.                    27                       OUT OF PAPER
  1757.                    52                       BAD FILE NUMBER
  1758.                    53                       FILE NOT FOUND
  1759.                    54                       BAD FILE MODE
  1760.                    57                       DEVICE I/O ERROR
  1761.                    64                       BAD FILE NAME
  1762.                    68                       DEVICE UNAVAILABLE
  1763.  
  1764.  
  1765.  
  1766.          These errors listed above are trapped in such a way as to let you
  1767.          correct the error and proceed, or abort the operation, retaining
  1768.          all data.  For other errors, you will only be given an error
  1769.          number, and then you are prompted to return to the Main Menu, as
  1770.          mentioned above.  (Data will still be kept intact.)  Since this
  1771.          program was written and compiled with Microsoft QuickBASIC, a
  1772.          complete list of error conditions and their corresponding numbers
  1773.          can be found in the Microsoft literature, if available.  The errors
  1774.          listed above, when encountered, print out the given error message
  1775.          as well as the number, in the error box.
  1776.  
  1777.  
  1778.  
  1779.  
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.                                     C.1
  1789.  
  1790.  
  1791.  Formfit! 3.0
  1792.  (C) Copyright 1987, 1988 Sidebar Software
  1793.  
  1794.  
  1795.  
  1796.          USING CONVERT.COM ON VERSION 2.x FILES
  1797.  
  1798.  
  1799.          As mentioned earlier, version 3.0 uses a different file structure
  1800.          than previous versions for both the system default file
  1801.          (FORMFIT.DFL) and for any files you've saved (filename.DEF).  The
  1802.          change was needed due to the addition of several new features in
  1803.          Formfit! V3.0.  Version 2.x users may continue to use their old
  1804.          definition files, and even their old default file, by running the
  1805.          CONVERT.COM program to convert them to the new format.  This must
  1806.          be done before running Formfit! for the first time.
  1807.  
  1808.          To convert files, simply run the program CONVERT.COM from the DOS
  1809.          prompt by typing CONVERT and hitting the ENTER key.  The program
  1810.          will prompt you for the name of a file to convert.  You supply the
  1811.          full name, including any extention name, and CONVERT.COM does the
  1812.          rest.  Along with the name of the file you wish to convert you may
  1813.          include path information.  Just supply it (in the standard DOS
  1814.          format) when prompted for a filename by CONVERT.COM.  You'll have a
  1815.          chance to abort before the program runs if you need to.
  1816.  
  1817.          Once CONVERT.COM has converted the file for you, it informs you
  1818.          that it was successful, and gives you a chance to convert another
  1819.          file if you wish.  When CONVERT.COM is told that no more
  1820.          conversions are desired, it returns you to the DOS prompt.
  1821.  
  1822.          Each file that is converted retains the same name it had before
  1823.          conversion.  Additionally, a copy of the original file (before
  1824.          conversion) is also saved, with the same filename, but with the
  1825.          extention .OLD attached.  For example, converting MYFILE.DEF
  1826.          results in a converted MYFILE.DEF and a file called MYFILE.OLD both
  1827.          on the specified directory.  Make sure there's enough room on the
  1828.          desired directory for the additional file.
  1829.  
  1830.          CONVERT.COM checks the file to see if it's already a version 3.0
  1831.          file, and if so, it informs you and will not convert it.  You still
  1832.          have the option to continue with conversions.
  1833.  
  1834.  
  1835.  
  1836.  
  1837.  
  1838.  
  1839.  
  1840.  
  1841.  
  1842.  
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.                                     D.1
  1851.